==========================================================
  SwissTD Playground — running it locally
==========================================================

First: Docker Desktop must be installed AND running.
Free of charge: https://www.docker.com/get-started/
It is running when you see a whale in the menu bar or task bar.


----------------------------------------------------------
  WINDOWS
----------------------------------------------------------

1. Double-click:  SwissTD Playground starten.bat

2. Windows may say "Windows protected your PC".
   -> click "More info"
   -> click "Run anyway"

3. Done. A black window opens and shows what is happening.


----------------------------------------------------------
  MAC
----------------------------------------------------------

1. Double-click:  SwissTD Playground starten.command

2. The FIRST time, macOS blocks the file. You will see:
   "Apple could not verify ... is free of malware."
   -> click "Done". (NOT "Move to Trash"!)

3. Now grant permission:
   -> Apple menu (top left) -> "System Settings"
   -> click "Privacy & Security" on the left
   -> scroll all the way down on the right to "Security"
   -> it says: "SwissTD Playground starten.command was blocked"
   -> click "Open Anyway"
   -> enter your Mac password

4. Double-click the file again.
   It starts now. This permission is needed ONCE only.

   Why this happens: the file is not registered with Apple. That
   requires a yearly fee we do not pay for a learning tool. The
   contents are open — you can read the file in any text editor.


----------------------------------------------------------
  WHAT HAPPENS NEXT
----------------------------------------------------------

A window opens and shows the progress:

  1. Docker downloads the parts (about 2 GB the first time,
     a few minutes depending on your connection)
  2. All services start
  3. Your browser opens at  http://localhost:8080

You can leave the window open. To close it: press Enter.


----------------------------------------------------------
  REMOVING IT AGAIN
----------------------------------------------------------

Stop:    stop the containers in Docker Desktop
Delete:  move the folder "SwissTD-Playground" in your home
         folder to the trash


----------------------------------------------------------
  NOT WORKING?
----------------------------------------------------------

"Docker nicht gefunden" / "Docker not found"
   Docker Desktop is not installed. See above.

"Docker Desktop laeuft nicht" / "Docker Desktop is not running"
   Start Docker Desktop and wait until the whale sits still.
   Then double-click the start file again.

On the Mac a text editor opens instead of a window
   Then the file was downloaded on its own instead of from this
   archive. Download the archive again and unpack it first.

Nothing happens at all
   The whole playground also runs in your browser, no install:
   https://pg.swisstd.ch
